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DC CURRENTS 
August 16: Turbo! Meqafont! 


Words of power and colossal size, those. (Or do they 
sound like what R2-D2 would say when he’s 
annoyed?) They are the names of two brand new 
products for the Atari, one hardware and one 
software, which Frank Huband will demonstrate at 
the DC group meeting on Tuesday, August 16. We'll 
see if they live up to their powerful names. 


The NCT 810 Turbo, which is its full name, is a 
conversion board for the Atari 810 disk drive, which 
promises wondrous things: double density format, 
read, and write; automatic read of single density 
disks} data separator to improve disk speed 
tolerance; fast chip for faster reading and writing 
(twice as fast in double density)} backup facility for 
any disk with any protection scheme} no-solder 
installation in a standard 810; one year warranty, 
NCT, a California firm (the name means 
“Neanderthal Computer Things, if you can believe 
that), sells this device for $295 list, $230 "Users’ 
Group Introductory Offer." Frank ordered one, and 
assuming it arrives, he'll show it off, 


Frank’s other show-and-tell (which is for surer 
because he already has it) is Megafont, a software 
package for Epson and Prowriter printer owners 
which allows printing user-defined character sets, 
Megafont is a new product of XLent Software, a 
Washington-area firm. 


For meeting time and place, see the top of page 2. 


DC Library News 
by Bob Danson, DC Librarian (780-0758) 


The DC Library continues to expand, with Disk #12 
released at the June meeting and Disks #14, 15, and 
16) and A.N.A.L.O.G, #12, released at the July 
meeting, 


Disk #13 is a copy of the ANTIC Photo Graphics 
disk, which is a collection of Graphics & 
"photographs" and a "slide-show" type program to 
show them. 


(contd. on page 3) 


and Northern Virginia 


NOVATARI NOTES 


Twi-night Doubleheader August 14; 


Martha Montague’s presentation of educational 
software at the July meeting of Novatari 
encouraged a lot of people to think that the scene in 
educational software for the Atari is getting a lot 
better than it was. We’re going to follow up at the 
August meeting (Sunday August 14) with a sort of 
free-for-all, come-one-come-all show and tell 
session on educational software we have known and 
loved, or hated, or been bewildered by, or written 
ourselves, or whatever--you get the idea. If you've 
been using your computer for education of yourself 
or your children (besides just education about the 
computer itself), come prepared to share your 
experiences. Bring programs with you that you have 
bought or written, and show how they work and how 
they could be improved, if at all. 


For the second part of the program, Joe Waters will 
demonstrate a tax preparation package he has 
written for Visi-Calc, the well-known “electronic 
spreadsheet" utility. Remember, only eight more 
months to April 15} come get an early start (how’s 
that for ruining a perfectly nice summer day?). 


For directions and times, see the top of the next 
page, 


DC GROUP MEETINGS 


are held on the third Tuesday of every month in 
Room 543 of the National Science Foundation 
offices, 1800 G Street Northwest, Washington, The 
closest subway stop is Farragut West, on the Blue 
and Orange Lines. Take the 18th Street exit, and 
walk south (against the flow of traffic) down 18th 
Street for 3 blocks to G Street. The building is on 
the southwest corner of 18th and G} it can be 
identified by a sign for the Madison National Bank 
on the corner. Front entrance is in the middle of the 
block, Parking is available in the building, for a 
fee, The entrance is on the west side of 18th 
Street, between F and G, Meetings begin at 5130 
PM, and usually last until @ or 9 


NOVATARI MEETINGS 


are on the second Sunday of the month, Novatari 
meets in the Greenbriar Community Center, on 
Stringfellow Road in Chantilly, Virginia. 
Stringfellow Road, also known as Route 645, runs 
south from U.S, 50 a little more than two miles west 
of the Fair Oaks Shopping Mall, which is at the 
intersection of I-66 and 50, There is a traffic light 
where Stringfellow Road meets 50. The Greenbriar 
Community Center is on the left-hand side of 
Stringfellow Road, 1.4 miles south of 50, There is a 
small parking lot in front, and a larger one just 
north of the Center (that is, just before you get to 
it), which is connected by a walkway. The meeting 
room is available from 5 to 9 PM. The first couple 
of hours are normally unstructured, open house 
style, with people free to come and go and chat with 
one another as they wish. Organized activities--the 
monthly program presentation, and any necessary 
business--begin about 7:00 PM, and usually last 
about an hour, after which there is some more free 
time before closing. 


CURRENT NOTES is the monthly newsletter sent to members of the 
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DC CURRENTS (cont’d.) 


Disks #14, 15, and 16 contain an assortment of 
game, demo, and utility software as noted on the 
listings below. The programs on these disks are the 
result of contributions fram a number of Group 
members, with partiwlar thanks going to Bruce 
Blake--inany of the programs and text files were 
written or provided by Bruce, 


Disks #14, 15, and 16 also represent a new format 
for the DC Library. When the disks are booted, a 
title page appears on the screen containing the disk 
number, while an AUTORUN program loads and then 
executes a menu program. The menu program can 
RUN a BASIC program and, if necessary, an object 
program} can load DOS; and can list documentation 
files. The documentation files (.TXT) provide 
essential information on using a program when the 
program functions are nat obvious. Try ane of these 
new disks and let me know if this format should be 
continued in future Library Disks. 


A new Library Index was available at the June 
meeting, As requested at an earlier meeting, an 
Index to the A.N.AsL.O.G, disks was distributed. 
These Indexes are in two parts--one sorted in 
alphabetical order by file name for the entire set of 
disks, and the other sorted in order by disk number. 
T'll try to have a new Index listing by the August DC 
meeting, 


Finally, no material is now on hand for future disks. 
More programs are needed! If you have any public 
domain software, or have an idea for future disks, 
please let me know, 


Program Correction 
by Bob Danson 


If you obtained Library Disk #12 prior to the July 
DC meeting and your Atari doesn’t have a "Fast 
Chip", then the following statement is needed in 
program DRAWHAT: 


29 IF XL=-0 THEN é0 


This addition is necessary because of a bug in the 
normal floating point math chip--the use of -0 in a 
computational statement produces an invalid 
number. 


New DC Program Chairman Wanted 


Craig Smith has done yeoman service as the DC 
Group’s Program Chairman for a year and a half. 
Now the pressures of his new job make it necessary 
for him to pass on that responsibility to someone 
else, Here’s a chance to be a big help to the group, 
and not incidentally to get to hear the programs and 
presentations and people you'd enjoy the most 
yourself, for the effort of a few phone calls a 
month. If you're willing to give it a try, call Frank 
Huband (527-4770), 


Current Notes extends the appreciation of the group 


to Craig for all his efforts and the interesting 
programs he has provided us. 


De16 


Deis AUTOGEN.BAS GENERATES AUTORIN FILE UTIL 

AUTORUN3.BAS MULTI-FUNCTION AUTORUN UTIL 

OCMENU.BAS — MENU PROGRAM UTIL = BBOOT.1XT INFO ON IPL TITLE SCRN DOC 

pe14 DEFEND.OBJ DEFENDER TYPE GAME GAME © CAESARC.BAS ROMAN NUMERAL CLOCK DEMO 


DISKPEEK.BAS LOOK AT DISK SECTORS UTIL 


CREATION.BAS PATTERN GROWTH GAME 


ANTUARS.BAS GOBBLE UP ANT EGGS GAME HoMETHVE.BAS HONE INVENTORY PROGRAM UTIL CYPHER.BAS DISK CRYPTO EWDECODE UTIL 
ATARIGZ5.LST {SEE SCRIPTORTAT) AUK LVELL.BAS DRILL FOR OIL € MAKE $ GAME CYPHER.TXT INFO ON USING CYPHER DOC 

AUTOBS® BAS 858 AUTORUN MAKER UiIL pILOT.TxT INFO. ON USING PILOT —00C_—OCMENU.BAS MENU PROGRAN USL 
BROOT.TAT —OESCR. OF BOOT DISPLAY DOC — pyLoT.xLT _PILOT-BASIC TRANSLATOR UTIL HICRODOS.OBJ ADDS EXTENSIONS TO DOS 0S NO 


BUBLSORT.BAS SORT DEMONSTRATION PGY UTIL 
CLOSEOUT.BAS EAT OOTS/SHOOT/CLIMB = GAYE 


PILOTEOT.BAS EDITOR FOR PILOT.XLT © UTIL 


MECROOOS.TXT INFO ON USING MICRODOS DOC 


PILOTEX1.PIL SAMPLE PILOT PROGRAM AUX MODDOS.BAS CONFIGURES ATARI DOS UTIL 
CLOSEOUT.1XT INFO ON USING CLOSEOUT DOC py. oTEX2.PIL SAMPLE PILOT PROGRAY AUX MODDOS.TXT —INFOR ON USING HODDOS 00C 
COVERSCR.BAS FILL-UP SCREEN IN TIME GAME — pyiovEXa.PIL SAMPLE PILOT PROGRAM AUX MODEL@ BAS GITA ORAMING TOOL om 
OOYENU.BAS —-HENU PROGRAM UTIL PILOTEX4,PIL SAMPLE PILOT PROGRAY AUX MODEL.1XT INFO ON USING MODE{@ —00¢ 
FRO een ioe, RLIES. GAME PILOTEXS.PIL SAMPLE PILOT PROGRAY AUX MODELGEX SAMPLE MODEL® PICTURE Al 
PROGSEP2.BAS COMM, PG, BUFFER UTIL UTIL  pyLOTEX6.PIL SAMPLE PILOT PROGRAM AUX — SHAZE.BAS © VOI THE MOVING LINES GAME 
PROGSEP2.TXT INFO ON USING PROGSEP2 DOC  sialom,eas SLALOM SKI COURSE GAME RAHOISK.BAS SEQ, 1/0 TO UNUSED RAY 0S HO 
SCRIPTOR.BAS TEXT EDITOR/FORMATTER UTIL penap.BAS 8B-COLUPN DISPLAY DEV. 05 HO RAMDISK.TAT INFO ON USING RANDISK DOC 
SCRIPTOR.TAT INFO ON USING SCRIPTOR OOC_ yi 0EOBR.TXT INFO ON USING VIDEO88 00 —RITEBACK.BAS HOW TO MOO ATARI DISK EHO 
SRO is He OLS GAYE VOPEN.BAS OPEN ROUTINE FOR VB0 AU —SYSTAT.BAS DISPLAY OF SYS STATUS UTIL 
TUIST.BAS GRAPHICS PATTERNS GRAPH yEDGE.8AS ATARI ODS EXTENSIONS 05 MO XREF.BAS BASIC XREF LISTING PG UTIL 
WEDGE.TXT INFO ON USING VEDGE DOC -—XREF.LST BASIC XREF LIST CODE CODE 
WINOOUS.BAS DEMO OF VBB WINDONS AUX —XREFBAS.IXT INFO ON USING XREF.BAS OC 


XREFLST.TXT INFO ON USING XREF.ST 000 
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###ARMUDIC IN TRANSITION### 


The A MUDIC Bulletin Board serving our two 
groups (and Atarians around the country) has been 
developed and maintained at his own expense, in 
money and time, over the past two years, by Frank 
Huband. Now Frank is ready to move on to other 
projects, and the clubs must confront the question 
of whether we want ARMUDIC to continue. To keep 
it going will take a fairly substantial commitment of 
money from the treasuries, both for front-end 
capital and for ongoing operating expenses, as well 
as a commitment of time from someone to serve as 
SYSOP, There was some discussion of this at the 
July meeting of the DC Group, where the opinion of 
those present seemed generally to favor making an 
effort to continue ARMUDIC, The Novatari group 
will be discussing the question at the August 
meeting, If you can’t come to a meeting, and you 
have an opinion you’d like to have heard, write or 
call your editor or one of the club presidents (Steve 
Steinberg and Frank Huband). 


###ATR8000 USERS’ GROUP FORMING##* 


At the July meeting of the DC Group, Craig Smith 
demonstrated the ATR2000 expansion box for the 
Atari, which lets you hook in multiple disk drives 
(of any description), and gives you the capability to 
run CP/M programs. A number of members of the 
group have now acquired these devices, and some 
have expressed some interest in getting together 
periodically to exchange notes on their use, If 
you're interested in participating in an ATR8000 
Users’ Group, call Craig Smith at (301) 577-3557, 


###CLASSIFIED### 
FOR SALE? 
FPERCOM single-sided, double-density disk 
drive (main drive, with controller), List $599} asking 


$450, 


AXLON RAMDISK (128K), including RAMROD 
firmware} asking $350, 


EPSON MX-100 printer, with GRAFTRAX+ 
asking $450, 


BMC 12A green-screen monitor} asking $65. 


All asking prices negotiable. Call Craig Smith, 
(301) 577-2557, 


###RANDOM BITS### 


Miner 2049’er Ti 
Arthur Leyenberger, Jersey Atari Computer Group 


If you would like to go directly to any level in Miner 
2049’er then do the following: go to the first 
platform above ground level and move to the far 
right of the screen CEd, note--this is just to keep 
you safe from being killed while you're doing this]. 
Then, type 2137826861. Now press [SHIFT] and the 
level that you wish to go to and you will go there 
instantly. You can continue to change levels from 
anywhere in any level by simply pressing SHIFT + 
level #, No need to type in the 10 digit number 
after the first time, 


NBs Electronic Bulletin Board Established 
(thanks to Art Corte for this item) 


An electronic bulletin board which will enable users 
to exchange information and read bulletins on 
microsomputer-related topics has been established 
by the Commerce Department’s National Bureau of 
Standards. 


Information on topics such as conferences, 
seminars, and workshops, telecomputing services, 
user and special interest groups, other electronic 
bulletin boards, publications, and new products and 
technology will be available. Users will be able to 
update the information and recommend additional 
entries. 


Both federal and non-federal users who have the 
appropriate terminal capability (ASCII, 300 baud, & 
data bits, no parity, 1 stop bit) will be able to reach 
the exchange by dialing 301/948-5718, 


Developed and administered by the bureau's 
Institute for Computer Sciences and Technology, the 
Microcomputer Electronic Information Exchange 
(MEIE) will be available 24 hours a day, 7 days a 
week. 


Another bulletin board system, cosponsored by ICST 
and the Computer Performance Evaluation Group 
(CPEUG), was developed in 1981 for exchanging 
information on computer performance evaluation 
topics. To reach this system, dial 301/948-5717. 


For further information on MEIE contact Dennis 
Gilbert or the system operators, John Junod and 
Lynne Rosenthal, National Bureau of Standards, 
Technology Building B266, Washington DC 20234, or 
telephone 301/921-3485, 
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THE SAGA OF PLANDEFRON SEVEN 
THE FOX FIGHTS ALONE 


Planetary Defense Squadron Seven had just proven itself 
as a fighting unit. Only two days before they had driven 
off an attack upon Collins Base and its vital stores, but 
at a terrible cost. Now with only one of the eight ships. 
Foxtrot, "the Fox"..able to fight, the entire system lay in 
grave peril... 


for the sentinel posts had Just reported an incoming craft, 
its zigzag maneuvers a certain prelude to attack. Then the 
outposts fell silent. 


AHHH SEIS HHH aH SB IB I aE 


SEVEN FOX is a game for one to five players of varying 
skill levels who each take a separate action station as the 
crew of the FOX in its desperate bid to intercept this attacker 
bent on destroying an entire planet. The game requires an 
ATARI# computer with at least 46K of memory,(24K with 81@ Disk) 
a model 41@ Program Recorder, a BASIC language cartridge, a 
a pair of Hnob ("paddle") controllers, and a pair of joysticks. 


Special AUDIO TRACK FEATURES: a "radio play" to provide 
background, and an audio-visual "briefing" for beginners, 
are available on the cassette version. 


Cassette Retail $19.00 each 


5 1/4 inch Floppy Disk (no briefing) 
$24.00 each 


Find me at meetings, leave an ARMUDIC note for #230 (WANT-ADS), 
or write: 


Bennett Rutledge, CDP 


327 South Wayne Street 
Arlington: Virginia 22204 


#ATARI is a registered trademark of Atari, Inc. 


###GROUP ORDER FOR MODEMS### 


If you want to use your Atari for 
telecommunications, to call up ARMUDIC, or 
CompuServe, or the computer at your office, a key 
piece of equipment you will need is a modem (short 
for MOdulator/DEModulator) This converts the 
electrical signals from your computer into acoustic 
signals which can travel over telephone lines. 
Madems have been fairly expensive and cumbersome 
until recently, but technological advances have made 
them much more compact, easy ta use, and 
economical. Allen Lerman of the DC Group has 
negotiated with Anchor, a firm which specializes in 
manufacturing modems for personal computers, a 
group deal for our two groups to buy modems from 
Anchor's line, including their newest models, If we 
order as many as 35 (mixed and matched among all 
models), the price of each will be several dollars 
cheaper still, We will be taking orders (and money, 
since these have to be paid for in advance) at the 
August meetings of both groups. If you won't be at a 
meeting, but would like to join in the order, mail 
your check to Allen Lerman, 1495 Waterway Drive, 
Rockville, MD 20253, Make checks payable to Allen 
Lerman, Assume the higher price for the model you 
want} if the order is over 35 and the lower prices go 
into effect, you will get a refund of the difference, 


The following are the four madels available, and the 
prices for each, 


MARK Ii connects between telephone base and 
handset} answers, but not automatically} 
automatically switches between originate and 
answer modes} 3@ BAUD; 25-pin plug} uses 9-volt 
battery or power supply (not supplied); $73 (or $69, 
if order's over 35). 


MARK II! exactly same price and features as MARK 
I, except designed specifically for Atari} has 9-pin 
Atari plug; has full/half duplex switch, 


MARK VII: connects directly to telephone line} auto 
answer} automatically switches between originate 
and answer modes} 3¢@ BAUD} 25-pin plug} comes 
with 9-valt power supply} $10@ (ar $94). 


MARK XII: 1200 BAUD; automatically switches 
between 300 & 1200 BAUD} auto dial/auto answer} 
supposedly has same features as and is compatible 
with Hayes modem} 25-pin plug; comes with 9-volt 
power supply} $251 (or $230), 


Except for the MARK II, these do not come equipped 
with cables which fit the Atari. A cable will have to 
be bought or made. They are not difficult to make 
(parts are about $10); instructions will be provided. 


###FROM OUR CORRESPONDENT IN CRETE### 


Steve Hull, a Novatari member serving with the U. S. 
Air Force in Crete, is pretty dependent on mail 
order to satisfy his computing needs: He wrote a 
little while back about some of his experiences! 


I’ve had some mixed experienses with user support 
by a couple of software companies you might want to 
pass on to the group. 


First the good news! I sent my "Protector" disk, $5 
and a letter requesting upgrade to “Protector II" to 
Synapse Software. In less than a month I received 
the new disk by first class mail, Outstanding —- 
and Protector II’s about 1¢@% more game than its 
predecessor, Recommended. 


Now the dawn side, In March I sent my TextWizard 
1.2 disk and a check for $2® to DataSoft for an 
upgrade they had promised they‘d do, and «, I 
haven't heard one word from them since. Well, I've 
sort of heard from them. They cashed my check But 


no TextWizard II, no letter, nothing, Poor 
performance! 
I recently had my disk drive repaired by 


Microcomputer Service Center of Williamsport, PA w. 
they charged me $125, worked on the drive -- and 
set it at 300 RPM! It worked fine once I brought it 
back down to 288 myself. Can you believe that? 


Finally, a couple of months back I sent a check off 
to Computer Mailorder East for an NEC color 
monitor, and again -~ a cancelled check, but no word 
on the order. My luck has not been terrific lately. 


I don’t know if you can use this info, but I like to 
pass on experiences, good and bad, to help others: 


Steve Hull 
Box 291 
APO, NY 69291 


(Ed. note--Steve might appreciate hearing from 
some of you, if you get a chance to writes] 


###NEW DOCUMENTATION FROM ATARI+##* 


Atari has recently released an “Information Sheet" 
on its Macro Assembler, which should be of interest 
to those of you working hard on learning to program 
in Assembly language. It is reprinted on the next 
five pages. Thanks to Michael Focke for providing 
this to Current Notes, 
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ATARI MACRO ASSEMELER 
INFORMATION SHEET I 
06/07/83 


WHAT IS A MACRO ASSEMELER? HOW DOES IT DIFFER FROM THE ATARI 
ASSEMBLER/EDTOR? 


The purpose of both the ATARI Macro Assembler (AMAC) and the 
ATARI Assembler/Editor cartridge is to convert a series of 
assembly language statements (source code) imto machine 
instructions (object code) that can be executed by the 
computer’s 6502 microprocessor. In this respect both 
products perform the same function. However, there are 
significant differences between their capabilities and desian 
that should be understood to effectively compare them. 


The ATARI Assembler/Editor contains am editor, assembler, and 
debugger built into one 8K cartridge. The ATARI AMAC diskette 
contains a stand alone 10K program text editor (MEDIT) and a 
stand alone 17K assembler (AMAC) that are loaded from the DOS 
menu. The ATARI AMAC diskette does not include a debugger. 


MEDIT is a much more complete text editor then the integrated 
editor om the cartridge. MEDIT includes commands for cursor 
movement, search and. replace, block movement, insertion, 
deletion, and input/output. Because it does mot require line 
mumbers, MEDIT does mot have a rernumber commands The 
cartridge editor includes commands for search and replace and 
input/output. It also includes commands for avto rmimbering 


and ret bering of its source file which must have line 
mumberss 
AMAC is @ much more sophisticated assembler than the 


integrated assembler om the cartridge. Through features such 
as conditional statements, ‘MACROS’, ‘ECHO’, ‘INCLUDE’, and 
‘LINK’, AMAC makes it convenient to teep a set of predefined 
routines that are often used in many programs, thus 
increasing programmer productivity by decreasing program 
development time. AMAC reads a source file from disk and 
assembles a load-m-go object file om disk. The object file 
must be loaded from the DOS ‘L’ (binary load) option. The 
cartridge assembler reads the source code located in memory 
and assembles its object code also im memory. Thus, AMAC is 
able to assemble larger source files then the cartridge. 
However, it is more convenient to make source file changes, 
reassemble, and debug Using the cartridge. 


WHAT DEBUGGER WOULD YOU RECOMMEND FOR USE WITH THE ATARI 
MACRO ASSEMBLER? 


A ‘debugger’ or ‘debug’ program allows a programmer to 
execute 8 program and observe its effect om the computer’s 
registers and memory locations. It cam also allow the 


ay ie 


programmer to observe and manipulate memory changes ‘on the 
fly’ to isolate and correct program errors. The ATARI Macro 
Assembler does not include a debva program. However, you nay 
purchase Dunions Debugging Tool, availeble from the ATARI 
Program Exchange (APX #Z0150). It is also possible to use 
the debug program included on the Assembler/Editor cartridge, 
but since the cartridge must be resident in memory, you may 
have to change the origin of your program if it conflicts 
with the cartridge. In some cases there may mot be enough 
free memory left to load your program. 


WHAT IS A MACRO? HOW IS IT USED? 


The Macro feature allows the programmer to define umique code 
words which represent several operations: These code words, 
or ‘macro names’s may then be used in the operation field of 
@ source file statement as op codes. During assembly, when 
the mame of a macro is encountered, the multiple operations 
defined by the macro are imserted at that point, the object 
code is generated, and the macro is said to have been 
‘expanded’. This process of macro ‘expansion’ is repeated 
each time the macro name is encountered by the assembler. 


Once a Macro is defined, it may be referenced as often as 
necessary. Macros may be defined in a ‘SYSTEXT’ file, in the 
main program, or im am ‘INCLUDE’ file. Example 1 shows a 
very simple Macro definiton? 


Label Operation 


TEST MACRO 
PLA 
RTS 
ENDM 


Example 1 
In example 1, the macro mame is ‘TEST’. Notice that the 
Macro mame is placed im the label field of the first line of 
the Macro definition, with the keyword ‘MACRO’ im the 
operation field. A Macro definition always ends with an 
“ENDM’ statement. NOTE? THE ‘ENDM’ - STATEMENT MUST EE 
CAPITALIZED AND PRECEEDED BY AN EXPANDING TAE. 


Example 2 demonstrates how the Macro ‘TEST’ cam be called in 
subsequent source statements. 7 


Label Operation 


TEST 
TEST 


Example 2 


Lou 


Notice the Macro ‘TEST’ is called twice. When the program is 
assembled, the resulting object code will contain the 
instructions, PLA-RTS-FLA-RTS} the code is expanded once for 
each Macro call. 


HOW DOES A MACRO DIFFER FROM A SUBROUTINE? 


Notice that the use of a Macro call is different than the use 
of a subroutine. Each time a Macro is called, more object 
code is generated and the machine language program grows 
larger.s Whan a subroutine is called, only the statement 
calling the subroutine adds to the code size. Since the 
Macro function allows the passing of different parameter 
values with each Macro call, a Macro is particularly suited 
to a case where it is necessary to perform the same functions 
several tines using different paraneterse Example 3 
denonstrates the parameter passing capabilities of a macro 


Label Operation 


STORE MACRO VAL.UE,LOCATION 
LDA #41 
STA “42 
ENDM 


STORE 100,$CC 
STORE 200,$CD 


Exanple 3 


The Macro defined in Example 3 is given the mame ‘STORE’. 
The ‘Zi’ is to be replaced by the first parameter passed in 
the Macro call, and ‘42’ will be replaced by the second 
Parameters In simpler terms the function of the Macro STORE 
ist LDA #VALUE, STA LOCATION. In the first call to the Macro, 
VALUE is 100 and LOCATION is $CC. The object code generated 
will load the accumulator with a 100 and store it at location 
$CC. In the second call to the the Macro, the parameters 
passed are 200 for VALUE and $CD for LOCATION. The obJect 
code generated will load the accumulator with @ 200 and store 
it at location $CD. Example 4 illustrates the four source 
statements that replace the two macro calls im example 3- 


Label Operation 
LDA #100 
* STA $CC 
LDA #200 
STA $CD a 
Example 4 


See chapter 6 of the ATARI Macro Assembler reference manual 
for more details om Macros. 


ie 


WHAT ARE THE ’ORG’ AND ‘LOC’ COMMANDS? 


The ‘ORG’ or ‘Origin Ci ter’ pseudo operator is used to 
specify the absolute beginning address to which object code 
is to be assembled. For example if the first statement in the 
source code is ‘ORG $600’ the object code will begin at 
memory location 600 hex. The ‘ORG’ pseudo op may be used in 
@ program as often as desired to create non-contiquous 
sections of object code. 


The ‘LOC’ or ‘Location Counter’ pseudo operator is used to 
set the assembler’s internal location counter. This allows 
code to be assembled es though it resided beginning at the 
locetion im the ‘LOC’ pseudo op. For example, if the first 
source statement of a program is ‘ORG $600’ and the second 
statement of the same source program is ‘LOC $1000’ the 
subsequent code will be loaded at location $600 but will be 
assembled as if it were resident at location $1000. This 
means that in order to execute properly, the code must first 
be moved to location $1000. The code is resident at the 
‘ORG’ address but is executable only when moved to the ‘LOC’ 
address. 


WHAT IS THE ‘’SYSTEXT’ FILE THAT IS INCLUDED WITH THE ATARI 
MACRO ASSEMBLER? 


The ‘SYSTEXT’ file included with the ATARI Macro Assembler 
contains a series of equates which define commonly used 
locations in the ATARI operating system. The locations for 
the Input/Ouput Control Blocks, Player/Missile Graphics and 
many others are defined using the standard OS mnemonics for 
the locations. For example the location called HFOSFO is the 
horizontal position of player mumber 0, which equates to 
location $0000. If the SYSTEXT file is specified im the AMAC 
command line by entering S=DiSYSTEXT, or specified in the 
program with the statement INCLUDE D:SYSTEXT, all of the 
definitions in the SYSTEXT file will be accessable to the 
main program. It is possible to create your own ‘SYSTEXT’ 
type files with their own unique filenames which cam be used 
in the same manner. 


WHAT ARE THE “INCLUDE’ AND ‘LINK’ FUNCTIONS AND HOW DO THEY 
DIFFER? 


The ‘INCLUDE’ pseudo operation is a very powerful feature 
that allows the programmer to include other assembly language 
source files im the main program, One can keep libraries of 
often-used source routines and break up long programs into 
shorter, more manageable INCLUDE files. When the INCLUDE 
statement is encountered during assembly, the included file 
is assembled immediately. The assembler returns to the main 
program at the end of the included file. 


-/@0- 


The ‘LINK’ pseudo operation also allows other assembly 
language source files to be included im the main program 
LINK differs from INCLUDE in that the assembly of the main 
file is completed before the linked file(s) are assembled. 


THE FOLLOWING IS A LIST OF SPECIAL CONSIDERATIONS WHICH 
SHOULD BE KEFT IN MIND WHEN USING THE ATARI MACRO ASSEMBLER. 


1. The source code for a Macro must rot exceed 255 bytes. 
This is also true wher: a Macro is nested, i.e. placed inside 
another Macro- 


2. The ‘ENDM’ terminator of a Macro definition must be 
preceeded by one, atid only one, expanding tab character 
($7F). It must not contain a space before the tab character. 
It must not contain a comment. The best way to supply an 
expanding tab is to use the MEDIT Frogram Text Editor 
expanding tab capability. See chapter 3 of the ATARI 
Program-Text Editor reference manual. 


3. Remember that the object file created by the assembler is 
always a load-n-go file. If mo run address is specified for 
your program, either in the ‘END’ statement or the ‘0’ 
command line parameter for the assembler, it defaults to 
$0000. When the object file is loaded using the DOS L 
option, the system jumps to this address and the system will 
lock. up because $0000 is an OS data base location and does 
not contain a valid instruction. There are three ways to 
prevent this problem First, specify a rum address in the 
‘END’ statement of your program, such as ‘END $600’. Second, 
use the ‘0’ parameter in the assembler command line, such as 
DSFILENAME.SRC 0=$600. Third, load the file using the /N 
Parameter om the DOS ‘L’ option, such as L,DFILENAME.OBU/N. 
After the file is loaded, use the DOS ‘M’ option (run at 
address) to begin execution at the correct run address. 


4 Wher a string containing lower case letters is passed as a 
Macro parameter and defined im the Macro with a psuedo 
operation such as ‘DE’, two spaces are inserted at the 
beginning of the string. 
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